跳到主要内容

n8n

本指南将介绍如何在 NVIDIA Jetson Orin 设备上安装、配置和使用 n8n。n8n 是一个强大的可扩展工作流自动化工具，支持数百种内置集成。由于支持 Docker 且系统资源需求低，在 Jetson 硬件上运行非常流畅。

1. 概览​

  • 可视化低代码工作流构建器
  • 支持 300+ 集成（API、Webhook、数据库等）
  • 兼容 Docker，部署快速
  • 本地优先自动化（注重隐私）
  • 完全支持 ARM64 架构（Jetson）

本指南内容包括：

  • 基于 Docker 的安装
  • 持久化配置
  • 服务管理
  • 远程访问配置
  • 卸载与故障排查

overview

2. 系统要求​

硬件要求​

组件最低要求
设备Jetson Orin Nano / NX / AGX
内存≥ 4GB（推荐 8GB）
存储空间≥ 2GB 可用空间

软件要求​

  • Ubuntu 20.04 或 22.04（基于 JetPack）
  • Docker & Docker Compose
  • Node.js（可选，用于源码运行）

3. 安装 n8n​

方法 A：使用 npx (requires Node.js):​

# Download and install fnm:
curl -o- https://fnm.vercel.app/install | bash

# Download and install Node.js:
fnm install 22

# Verify the Node.js version:
node -v # Should print "v22.14.0".

# Verify npm version:
npm -v # Should print "10.9.2".
mkdir -p ~/.n8n
sudo chown -R $USER:$USER ~/.n8n
npx n8n

✅ 官方镜像支持 ARM64，Jetson 可直接运行。

方法 B：使用 Docker :​

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 -e N8N_SECURE_COOKIE=false -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

4. 访问界面​

n8n 运行后，通过浏览器访问：

http://<Jetson-IP>:5678

login

5. 常用命令​

操作命令
启动 n8ndocker compose up -d
查看日志docker logs n8n
停止服务docker compose down
重启服务docker compose restart
更新 n8ndocker pull n8nio/n8n

6. 可选：启用远程访问​

若需远程访问 n8n（如从其他设备）：

  1. 确保 Jetson 防火墙允许 TCP 端口 5678。
  2. 在 Compose 文件或容器中设置如下变量：
N8N_HOST=0.0.0.0
N8N_PORT=5678
WEBHOOK_TUNNEL_URL=https://yourdomain.com
  1. 若需 HTTPS，建议配置反向代理（如 Nginx + Let's Encrypt）

7. 故障排查​

问题解决方案
无法访问 WebUI检查 Jetson 是否开放 5678 端口
工作流未保存确保 ~/.n8n 或挂载卷可写
容器崩溃使用 docker logs n8n 查看详细日志
需要 HTTPS 访问配置 Nginx 反向代理 + SSL

8. 附录​

默认文件路径​

用途路径
n8n 配置和数据~/.n8n 或 ./n8n_data/
Docker 项目目录~/n8n
WebUI 访问地址http://<Jetson-IP>:5678

参考资源​